"""装饰器"""
# 由于函数也是一个对象，而且函数对象可以被赋值给变量，所以，通过变量也能调用该函数。
def now():
    print('2018-10-18')
f = now
f()
# 函数对象有一个__name__属性，可以拿到函数的名字：
print(now.__name__)
print(f.__name__)

"""现在，假设我们要增强now()函数的功能，比如，在函数调用前后自动打印日志，但又不希望修改now()函数的定义，这种在代码运行期间动态增加功能的方式，称之为“装饰器”（Decorator）。"""
def log(func):
    def wrapper(*args, **kwargs):
        print('call %s()' % func.__name__)
        return func(*args, **kwargs)
    return wrapper
# 观察上面的log，因为它是一个decorator，所以接受一个函数作为参数，并返回一个函数。我们要借助Python的@语法，把decorator置于函数的定义处：
@log
def now():
    print('2018-10-18')
# 调用now()函数，不仅会运行now()函数本身，还会在运行now()函数前打印一行日志：
now()
# 把@log放到now()函数的定义处，相当于执行了语句：
now = log(now)

# 如果decorator本身需要传入参数，那就需要编写一个返回decorator的高阶函数，写出来会更复杂。比如，要自定义log的文本：
def log(text):
    def decorator(func):
        def wrapper(*args, **kwargs):
            print('%s %s():' % (text, func.__name__))
            return func(*args, **kwargs)
        return wrapper
    return decorator

@log('execute')
def now():
    print('2018-10-18')
now()
# 和两层嵌套的decorator相比，3层嵌套的效果是这样的：
now = log('execute')(now)

# 经过decorator装饰之后的函数，它们的__name__已经从原来的'now'变成了'wrapper'：
print(now.__name__)
# 因为返回的那个wrapper()函数名字就是'wrapper'，所以，需要把原始函数的__name__等属性复制到wrapper()函数中，否则，有些依赖函数签名的代码执行就会出错。
# 不需要编写wrapper.__name__ = func.__name__这样的代码，Python内置的functools.wraps就是干这个事的，所以，一个完整的decorator的写法如下：
import functools
def log(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        print('call %s():' % (func.__name__))
        return func(*args, **kwargs)
    return wrapper
# 或者针对带参数的decorator：
def log(text):
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            print('$s %s():' % (text, func.__name__))
            return func(*args, **kwargs)
        return wrapper
    return decorator

"""
在面向对象（OOP）的设计模式中，decorator被称为装饰模式。
OOP的装饰模式需要通过继承和组合来实现，而Python除了能支持OOP的decorator外，直接从语法层次支持decorator。
Python的decorator可以用函数实现，也可以用类实现。

decorator可以增强函数的功能，定义起来虽然有点复杂，但使用起来非常灵活和方便。
"""

def test(func):
    def wrapper(*args, **kwargs):
        print('begin call')
        func(*args, **kwargs)
        print('end call')
    return wrapper

@test
def now():
    print('2018-10-18')
now()

import functools
def log(text=''):
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            print('%s begin call: %s' %(text, func.__name__))
            func(*args, **kwargs)
            print('%s end call: %s' %(text, func.__name__))
        return wrapper
    return decorator

@log()
def now():
    print('2018-10-18')
now()

@log('hello')
def now2():
    print('2018-10-18')
now2()

